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Introduction 



This manual describes the Sun-3 color board for people who need to interact ,- 
significantly with this board.' It provides a functional description of the board, 
and lists and describes all the addressable facilities on the board. . - ; ' r ,',' i' , 



l.i. Using this Manual* /:,'. .y'J-^ -The followingVectibns provide^nform \- " 



' -\" ^i .-'- '- '-. v^^f'"'r ;o'"M'^5^n;r^^''':;board;-eithertpjrepairiti'orfo^^^^ 

Manual Organization ■ ' -TMs manual provides different types of inform 

Chapter 2 describes what the board does at a high level, and introduces some of 
the principles used. Chapter 3 lists the various addressable devices in the board, 
and describes how to access them and what they do. Chapter 4 provides in-depth 
descriptions of the board functions, and Chapters provides examples of the code 
that sets-up and interfaces this board. / 

Fonts in Text In this manual, we use fonts to make things a little clearer. The most common 

fonts are Roman, typewriter, italic^ and bold. We use them as follows: 

Roman ; ' ' , 

Roman font is the standard for normal text, just as it appears here. 

Typewriter 

Typewriter font is mostly used for information in displays. 

Italic 

Italic font is either used for notes, or it represents a variable for which you or 
the computer must substitute some real value. For example: 

This field contains a pointer to register nn 

Bold 

Bold font indicates that something deserves more atiennon than the sur- 
rounding text. 
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1.2. Glossary In order to avjd- confusion, this manual uses standard definitions for some com- 

mon words. "j?iii.e are: 

Frame 'Buffer 

The mBnv3,]!that contains a copy of the image on the video monitor. 

RasterOp 

A- unit Wib mam'pulates data in the frame buffer. Also called ROPC 
(RasteHihjIhip). , 

" RasteiOp"^Mc&*{:. *, , , - , , . 

An addnettig-mode that runs data through the ROPCs.' 

• Pixel Mode ''■.,'''.'., ' ' " "■',. ''-'[ ,','';, 

An addiasag mode where each byte represents a 'PEL' (picture element) 
• •' on"the.scB3i-:* . • ' ' •% '''.'.' '.,' :.'■'"' „■ '■', ,- ;,• . '-:;"," ;; , ■";.;'.• '</-", ■' 
■'-','' . * ' ' > ' ^• ■'/'■-'"' ■ ',' ■'!} '• ' '" ' '■ 

■,'/' Woni. Mode ':.:': - " ' '; ''-'/' J ■'j^' ''-^ '^ 'V 'Vll'^ . ' r\>\i'^ ■■ , 
^ - ' , An'addBESiig mode where the entire frame buffer appears as 8 1 28K X 1 bit, . v.' 
'• ,■'■" >^ 'stairks'ocfiemory. • - .^- ■;''!',",..,'■•. ' '■'■''.'W■'-^':;'Jh\^^{y^r^^~'• '• ^^' ''Qy-'"ir'.' '-^ 



'. ,.,' 'DoublSBbfffi^ ;;■ f 

hi '' t '/-'-fTA^featarej^^ enables 



les thie coiof board to main^taih!iwoamages of fraLme|V''^;V' -iv' " 




'']'-" 'Deasserted' 'y-'^.' '/i;. .vjv' \V:'^ ':^ '^/^^■",r'''^: 'vr .-r/'^v-,: ' ■. ,'-'^.'!(. V'M''^-^ 
A sign^^;jasserted whenitis OFF or LOW. , - , ' ' 

1.3. References Refertothe^^owing documents for additional information:,' ! ' ' 

Principhxrf Interactive Computer Graphics (Newmanh & Sproul), ' ' 
VLSIT^fhlogy, Inc. IC V16160 DataSheety. ; • ' s ; 
Pixrectfi^trence Manual — Part Number: 800- 1 254 
Suri-3^<s,Srhoard Engineering Manual — Part Number: 800-1 366 
Suri Cmiiuration Procedures — Part Number: 8 1 3-2000 
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Color Board Overview .1.1..."....: ". .......'.:1. '.....';:„.l..-.i.....l...„...„ 7 

2.1. Addressing ..;. .- „.....'. ' .:... ■...1...:...'......... 1.'. :...„..:„_ ' 8 

2.2: RasterOps and Image Manipulation...!... .1.; .'..:.:„...:.! '^„:.: .....„;.:,'.„.. - 8 




Color Board Overview 



; This chapter contains an overview of the architecture and function of the Sun-3 , 

' color board, k describes whiat the board does, at a high level. ' ', 

': -This chapter^ intended to familiarize you with the basic functions of the board, ; 

, and the basii: concepts it uses. Subsequent chapters go into greater detail. . - '■ 




lat'proyides'a'megabyte i 
i; vV,x'^''wi ' frame buif^^ and circuits to manipulate the data in this RAM. The frame' buffer^v 
- " ■• ' < " contains the ^age on theVideo monitor; data'gbes from there directly to the'' •'•; 
video circuis: ' ^ - ' - , . ' / ;\ . [ , 

The followiig figure shows the major blocks of the board, and its relationship to 
the rest of tie' system: , , 
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Figure 2-1 The Color Board in the System 
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2.1. Addressin" 



2.2. RasterOps and Image 
Manipulation 



Jumpers on the 'col of. board select the board's base address, and whether it'';;-/H' : '- 
decodes 2 or 4 Mbytes of space starting at that base address. The board itself con- 
tains 1 Mbyte of frame buffer RAM and 1 Mbyte of control space, which con- 
tains registers, the color map, and an optional DMA space. With 2 Mbyte decod- 
ing, the frame buffer RAM occupies the first Mbyte, and the control space occu- 
pies the second. With 4 Mbyte decoding, the first 3 Mbytes provide three dif-. 
ferent methods of accessing the (same) 1 Mbyte frame buffer RAM, and the con-' 
irol space occupies the 4th Mbyte. 

The default is to use 4 Mbyte decoding, with the base address at 4 Mbytes. This 
makes the board occupy firom 4 to 8 Mbytes in VME address space. 

RasterOp chips provide the main tool for manipulating the image in the frame 
buffer RAM. The RAM is organized as 8 planes of 128 Kbytes each, and each of 
these has a RasterOp chip assigned to it. The RasterOp chips each have a 
number of writable registers; when data is written to frame buffer RAM, it is 
manipulated according to the instructions in the registers of the relevant 
RasterOp chip. 

The control space also contains a pseudo RasterOp unit, which acts like all 8 
RasterOps in parallel. Changes directed to this unit change all the RasterOps. A 
register allows you to mask any of the 8 planes, protecting them selectively from 
all accesses. 
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2.3. Color Map The color map is a 256 by 24 bit RAM circuit that uses ECL logic for fast access 

but is shadowed in a TTL circuit. The 24 bit locations each contain bits which 
describe a color; 8 bits of red, 8 bits of blue, and 8 bits of green. It uses a posi- 
tive coloring scheme; increasing the value of the 8 bits assigned to each color 
increases the intensity of that color. Turning all 24 bits OFF creates black, and 
turning them all ON creates white. 

The color map acts as a lookup table; 8-bit locations in the frame buffer (pixels) 
provide an index to a location in the color map. This allows each 8-bit pixel to 
■ ;, display a 24-bit color. The color map can contain 25 6 out of 16M possible color 

combinations., • . ; ,,' . > , ,, •", ' 
' ' ' ' '''' '' ' '.-'','''-,;''',- • •" . ' < , > -,,■■' 

2.4. Optional Features Some color boards contain an extra Mbyte of RAM for double buffering, and a ^ 

DMA circuit. Double buffering creates 2 frame buffer RAMs; this provides the ' 
, ' ability to display one on the screen while updating the other. A register allows 
you to designate one the background and the other the foreground, and to toggle 
this selection. ; „ ''; ,^;>^.';-',;;s' V '■''/'« > !' ' '.•','' 

V ; The DMA circuit allows you to^take an image stored on disk and write it directly 
i'..,''', to the frame buffer,,' " --•'. -.r- iv. ;.-,.<",_; , .-.:': •:-.■'. <.,„ :.-.-■, ,.-, 
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Software Model ;.. .•......:....■; ;.......„..:.:..„ .:...:':'r-;:.:.......:.-.^.::..::. :..... ,^ 13 

'r|;c;3. 1 ..'-Address Space Assignment ' l„.:l:!...l~;„.::..:i;!:...;..j;:.„:.^;.L;,;..„.:.;.: L'. . - ' 13 




iRegi 

;iv^;-}f;"^v Frame' Count Regisier;..:..;.:S::;...J.15...J^:;:lv:.ii:^.b:.^:;.£ii.4^ . 20 

■' , ;,, - ' ^ VME Interrupt Vector Register '. :„. : !;„..V..'....!...l..........ll...;; 20 

• '^3.3! Addressing Modes ..; .......i : . ..ll'.:.!..;. ' :; , 20 

Pixel-Mode Addressing ...' .- 28 

Word-Mode Addressing ..;. :...........:!.„:„'. :::: ! 28 



Software Model 



- ' V'''i=i '. -V 1 ,f;'' T^^^^iP^^^P^^'^^^^ a software model ofihecolorboard.. It lists the address-/,!';, 

-L , , •, \'y}ii'' » ' , able devices on the board and describes what they do. ' 'J ' /'■.":/' '''H 
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Table 3-1 Frame Buffer Addressing 



Offset from Base ■ 


Accessed Entity .' 


Description . , 


0x000000 — OxOFFFFF 


■ Word-Mode Memory 




Ignored' in 2 Mbyte decoding " 




• Frame buffer appears as a stack of eight 
memory planes. Each memory plane is 
equivalent to 128 Kbytes of system 
memory. A 32-bit word access 
' addresses 32 adjacent bits within a bit- 
plane. Eight, 16 and 32-bit accesses. 


0x100000— Oxlhhhhh 


Pixel-Mode Memory 




Ignored in 2 Mbyte decoding 




Frame buffer appears as 1 million 8-bit- 
deep pixels. Memory planes masked by 
Per-Plane Mask Reg are write and read 
protected. Eight, 16 and 32-bit 
accesses. Multiple byte accesses access 
multiple pixels. 


0x200000— 0x2FFFFF,or 


RasterOp Memory 


1 
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Table 3-1 Frame Buffer Addressing — Continued 



Offset from Base 


Accessed Entity 


Description 


0x000000 — OxOFFFFF 


- 


The eight RasterOp addressing modes 
are specified by the ropmode field in the 
status register. They are described later 
in this chapter. 


0x300000— Ox31hhhhor 
0x100000 — 0x01 hhhh 


Control Registers and Color Maps - 


This address range contains the color ^'' 
board control devices. ,^ .,' 


0x320000 — ' 0x3hM-hh, or 
0x120000 — OxiPFFFF. 


DMA Window Space ••';. - u ^ 


This space acts similarly to pixel mode > 
memory, during DMA accesses^ : , 



, -The following table's show, the addresses in the control space'. The first sh6ws 2 




'M00ffskrfr(mi'0asei^^M^^^B^^^&W^0^c^s^^ ^ 



-,,0x1.00 0.0 Or;T4-?30xl 



Oxioiqoo - 
bxio26oo''"- 
oxiosooo - 

0x104000 - 
OxlOSOOC - 
0x106000 - 
0x107000 - 
6x108000 - 



0x110000 
0x110200 
0x110400 



, 0x1 

''oxi 

0x1 
0x1 
,0x1 
0x1 
0x1 
0x1 



PPPiE; 

qioiE' 
d2diE 

0301E 
0401E 
0501E 
0601E 
0701E 
0801E 



0x109000 
OxlCAOOl 
OxlOBOOO 
OxlOCOOO 
OxlODOOO 
OxlODOOl 
OxlOFOOl 
OxllOlFE 
Oxll03FE 
OxllOSFE 



f^^Rast^^limg^ 

V^RasterOpuiiit J— ^bit-plane 1. ■ ' - ' '."^''v:" "" ' 

■ ' Rasterpp unit — ^, bit-plane -2.^ ■ - ■ 

RasterOp unit — bit-plane 3. ' 

RasterOp unit -^ bit-plane 4. 

RasterOp unit — '- bit-plane 5. 

RasterOp unit — bit-plane 6. 

RasterOp unit -7- bit-plane 7. 
'! On write, Pseudo RasterOp unit — will write to all ROPC 

enabled by Per-Plane Mask register. 

Status Register (16-bit) 

Per-Plane Mask Register (8-bit) 

Double Buffering Register (8-bit) 

DMA Window Origin (A 19 to A04) (16-bit) 

DMA Window Width Register (8-bit) 

Frame Count Register (8-bit) 

VME Interrupt Vector Register (8-bit) 

Red Shadow Color Map — Entries to 255. 

Green Shadow Color Map — Entries to 255. 

Blue Shadow Color Map — Entries to 255. 
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Table 3-3 Control Space Addressing — 4 Mbyte Decoding 



Offset from Base 



Accessed Entity 



0x300000 - 
0x301000 - 
0x302000 - 
0x303000 - 
0x304000 - 
0x305000,.-' 
0x306000 - 
0x307000 - 
6x308b00 -• 



0x30001E 
0x30101E 
0x30201E 
0x30301E 
0x30401E; 



RasterOpunit — bit-plane 0. 
RasteiOpunit — bit-plane 1. 



RasterOp unit 
RasterOp unit 
RasieiOp unit 
0x30501E 'RasteiOpunit 
0x30 6blE , RasteiOpunit 



0x30701E 
;-0x30801E, 

^0x309000 -■ 
^OxSOAOOl '- 



-bit-plane 2. 

-bit-plane 3. . 

-bit-plane 4.- . :''{_■} '- ■. /;,: -, ' /.■; 

-bit-plane 5. , i . > . ■ > 

■bit-plane 6. / ., 
' RasteiOpunit T-^ bit-plane, 7. , , ./ ,- ,., .• 
On write, Pseudo RasteiOp unit -7— will write to all ROPC . 
enabled by Per-Plane Mask register. , ,. '. " ; ;' ' ^Z , '[ 
; Status Register (16-bit) , /; , • . ,';. ;•',;, 

•Per-Plahe Mask Register, (8-bit). ; .. ; ' ',/',. „ > , ' , ,. ,; • > 



■X' 

I 




Ih^ 






L'l' 



Each RasteiOp unit has fourteen l(5-bit registers. The following table shows 
their address offsets from the base address of the RasterOp chip: 
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Table 3-4 RasterOp Unit Register Addressing 



ROPC 
Base Offset 



Data Bits 



Accessed Entity 



0x00 
0x02 
0x04 \, 
0x06 
0x08 ; 
OxOA'. ^ 
OxOC;' 



D15..D0 

,D15..IX) 

• D15..D0 

D15..D0 

D15..D0 

;;'D15..D0 

.•D15:.b9 



, Destination Register 

;' Source Register 2 — Least-significant word of SRC. ,'; ^ 

> Source Register 1 — Most-significant word of SRC. • :J ' ; 

Pattern Register. '-' ..'"-■ : '' ' ' '■. ; ;,'y'/jl X" 

' Maskl Register — Eriabled when "Opcount'* equal to zero; - ~ ' 



Mask2 Register — Enabled when * 'Opcount' ', equals ' '\yidth.;' ' . .■ 
Write as zeros, Read as Don't Care .' ', ^ ''!'.'./- o^.': 




0x10 
0x12 



D15..D0 



0x14^^ ' ' 


D15..D0 


0x16 


D15..D0 


0x18 


D15..D0 


OxlA 


D15..D8 




D7..D0 



-;D7.^D0^"^\ :-' Function Register.,. ;.>k.' ;a :•'';,:■ . '■ - ', ;.',.'-.w ',, .aV;. ;,!.!; 
D15..D0 Width Register — Specifies width of Raster in words. ^ " 

Opcounter — Lx)aded from Width Register when Opcounter 
equal to zero. Decremented every frame buffer write. Controls 
enabling of mask registers. 

Decoder output latch*— Read-Only. For diagnostic purposes. 
Gives output of RasterOp unit based on current register values. 

Manual load destination — Loads destination and strobes 
LD.DSTpin. For diagnostic purposes. 

Manual load source — Loads source register and strobes 
LD.SRC pin. For diagnostic purposes. 

Write as zeros, Read as Don*t Care 

Flag register for applications software 
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3.2. Control Registers 



Status Register 



This section describes the each of the control registers. Their addresses were 
provided in an earlier table. 

The status register contains 16 bits, and is cleared when a bus reset is issued. It 
contains the following fields: . , 



Table 3-5 - Bit Assignments for Status Register 



Bit 



Name 



'I -.; "i',,'^''-: r'r-'Kvi'y: ::\. I' ■ Function 



DO 



video enab 



When asserted this bit enables the video DACs. 



I .- 



Dl '.' update_ecmap 



',' .. When both this bit and the bit by the same name in the , 
' : ; status ^register are deasserted the host software can read 

or write the TTLshadovl' color map. When either of 
' these bits are asserted,' either the TTL or EOL color ': 




, ,., , . - '■• ' ," .'■,"-'1'"'' '''I'' ' 'V/f-f' ;p /•'!ft^- ;'■•";•-•'(' ;/' ''>;-Vv '■^''',;'\:''-^ ■> ' > r-'t ;•..'«'',.' ■.v'aiI 

D3 ■' V ' '' ropmodeO, ;, ' m :,• .jHv.t'LSB of -S-bit field specifying current RasterOp-modi 



-mode. 



'(I' 



D4 ropmode 1 

D5 r6pmode2 

D6 [" inpend 



Bit in 3-bit field specifying current RasterOp-mode. 



> '! 



MSB of 3-bit field specifying current RasterOp-mode. 
;.;• Read-only." Asserted if board is interrupting. 



D7 


retrace -, ' . 


, . Read-only. Vertical retrace in progress. 




D8 


Resolution 


, Read-bniy. ^ "0'* -> 1 152x900 display; 
1024x1024 display., 


"1"=> 


D9 


Flag09 


Read-only. User-system definable jumper - 
to lun Pixrect software. 


— must be 


DIO 


FlaglO 


Read-only. User-system definable jumper - 
to run Pixrect software. 


— must be 


Dll 


Flag 11 


Read-only. User-system definable jumper. 




D12 


Ragl2 


Read-only. User-system definable jumper. 
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Table 3-5 Bit Assignments for Status Register — Continued 



Bit 


Name 


Function 


D13 


Flagl3 


, Read-only. User-system definable jumper. 


D14 ; 


-Eagl4 -"-: \; 


- ■ , „ Read-only. User-system definable jumper. , 


D15 ■ 


-Hagl5 \:'. " : . 


: ';, ■ Read-only. User-system definable jumper. 



..t)r.». i>io«« x/TAoir-- r> ;.A;o«VvV . r : /■- . - ^-m,^ u«.«^s]^ register is an 8-bit register used for restricting frame buffer access to 

)it7planes of the frame buffer memory. It also restricts access to the 




';t''^';^':^i!^^;^ ^'';'?>Vf;TV r^ J'''\Bit Assignments for Double Buffering Registe 



ister 









'1:,B^r'■'Jy'''•^•• '>, ,■•'-: Name['^}^\-'-i 



Function 



-D0,^D7 , -7' V?, Reserved ; ;'%-/ ". \ 
^'f/W'tD 8 '■C^^'^- . update_^ecmap;.v| ; ;' 



D9 



wait 



; These bits are currently not used. 

l;\yhen both this bit and the bit by the same name in the 
- status register are deasserted, the host software can read 
; or write the TTL shadow color map. When either of 
' these bits are asserted, either the TTL or ECL color map 
is transferred to the other during verdcal retrace, depend- 
ing on the state of the read_ecmap biL When cleared, 
this bit takes effect immediately; when set, this bit is 
sampled by the leading edge oi" vertical retrace. 

This bit can be used to determine when a color map 
update or switch of foreground/background has taken 
effect. When wait is low, vmting a " 1 " sets the bit. The 
bit then remains high until a complete vertical retrace 
period has elapsed, after which it clears itself. 
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Table 3-6 Bit Assignments for Double Buffering Register — Continued 



Bit 



Name 



Function 



DIO fast_read When asserted, a read access to the frame buffer 

memory returns an immediate DTACK but also returns 
invalid data. Using this mode can speed operations like . 
scrolling by 50%. 



Dll read_ecmap ' .> This bit specifies the direction of data transfer bet>yeen J-. 

; the ECL and I'lJL color niaps when "updaie_ecmap\',is ;, 
' active. ; When cleared, die ECL map is loaded from the ,/ 

, ,. ,. ■ ' ,. ■' ', J,;i'lL/ map;\yhen set, the i'lL. map is loaded from the ,'.. 
, ,,, , . .ECL map.< ,'.«>.. 




i 
i 



.'. ' i ,.-/ iVi,;! '"read arid -"hidden-read** cycles, access memory set B. v '\ 
' ' ' -. Memory sets are described in the chapter Color Board '"' 

. '[' ' / Functions.' . \. .; ^ ■■/, ' -''''.'.'/ 

D15 display_b , '; When this bit is low, the contents of memory set A are 

; output to the CRT. When this bit is set, the contents of , 
' ' ' ' ^ ' , memory set B are output to the CRT. This bit is syn- , 

. chrbnized with the start of vertical retrace; changes do 
' not take place until the start of vertical retrace. This 
prevents * 'tearing*', where you see one picture on top of 
the display and another picture on the bottom. 



DMA Window Origin 
Register 



DMA Window Width Register 



This register specifies the beginning of a DMA window. It represents the upper 
left hand comer of the window, and it must be on a pixel boundary (mod 16). 
The use of the DMA window is described in the chapter Color Board Functions. 

This register holds a number representing the width of the DMA window divided 
by 16. It represents the width of a line in the DMA window; when the number of 
pixels divided by 16, minus 1 ((pixels /16) -1) is equal to the value in this win- 
dow, it starts a new line. 



#7 sen 

^w mcrtKvstems 



Company Confidential 



mc rosy St ems 



20 



Su-n-? Color Grarbic^ Bn.'c 



jne Count Register 

VME Interrupt Vector 
Register 



3.3. Addressing Modes 



This read-only register is incremented by the hardware each vertical retrace. 

This register contains the 8-bit interrupt vector which the color board provides to 
the VMEbus when it produces a vectored interrupt. Note that the color board can 
also use a polled interrupt scheme implemented with the inpend bit in the status 
register. . 

^ In the 4MB space, the first megabyte is word-mode memory space, the second ' 

\ megabyte is pixel-mode memory space, the third megabyte is RasterOp memory 

space and the fourth megabyte contains the control registers, the color maps and 

' the optional DMA window space. However, when used in the UNIX environ- - 

merit the word and pixel-mode memory spaces are never used, and this address- 

■ ing space can be reclaimed. Shrinking the addressing space to 2MByte is essen- 

-~ tial for a three board, 24-bit color configuration that must fit into the 24-bit 

";* addressing sub-space of the VME. 



' "; ,The two non-RasterOp addressing modes are: -V :* ''^:,,iv.K,i* r- '■' Jr ^'^ ' 

C:\Word-ModeMemoryr-'.."' , '" ^^ /;■ ■ •, -" - /'"'^-' v^-i''" ^;h^ .''':• .';"■"'■->?,'■■ 




-Jih". iiW masked by. the per-plane mask register are read and write' protected (masked 

/ ' bits return zeros on read). 8/16/32-bit accesses transfer 1/2/4 pixels simul- 
\ ■ ' taneously. Pixel-mode doesn't use the frame buffer RasterOp chips. 

The remaining eight addressing modes, which are selected by the ropmode bits 
' in the status register, use the RasterOp chips. There is one RasteiOp chip (ROPC) 
for each of the eight bit planes of the frame buffer. As described in the chapter 
Color Board Functions , each RasterOp chip has source, destination and pattern 
registers upon which to perform a three operand RasterOp. The source and desti- 
nation registers may be automatically loaded on read or write accesses to the 
frame buffer memory. The source register may be loaoed from the data bus on a 
read or write access, the destination register may be loaded from the frame buffer 
memory on a read or a write access, and the pattern jiegister is loaded by writing 
direcfly to it. Note that reads and writes to memory and RasterOp chips are only 
performed on planes not masked by the per-plane mask register. 

The RasterOp chips are 16-bit devices and not all 32-bit VME bus cycles appear 
software compatible with 16-bit VME bus cycles. All 32-bit bus cycles arc bro- 
ken down into separate 16-bit cycles on the board. Therefore, in RasterOp 
modes 0,1,4,5 and 6 (see the following table), a 32-bit read followed by a 32-bit 
write is not the same as a 16-bit read followed by a 16-bit write followed by a 
16-bit read followed by a 16-bit write. Note that 32-bit data transfers on 
MC68010 CPUs are broken into nvo 16-bit bus cycles and that this incompatibil- 
ity betVr'een Sun-2 and Sun-3 color boards may be masked by a Sun-2 CPU. 
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The RasterOp Mode table uses the following shorthand notation for ropmode: 
The first character specifies either parallel (P) or single (S) transfer. The second 
character specifies either load ROPC destination registers on a read (R) or write 
(W) access. The third character specifies either load ROPC source registers on a 
read (R) or write (W) transfer. The last three characters specify word- (WRD) or 
pixel- (FIX) mode transfer. The eight RasteiOp addressing modes are described 
in the following table: ' ' ' .. 

, Table 3-7 . RasterOp Addressing Modes 



Addressing Mode 



-{ RasteiOp Addressing Modes . ' 
Notation ' . '> ? . -V - Description 



'''<\'':%f;^)^:4 



1 —Parallel Word Mode 
with RasterOp 



PRVk^WRD :, ■ , One or two 16-bit words are written in parallel to each plane.:, 
' ' ,' >; not masked by the per-plane mask register! ; Aoiesses^;?/ ;■);,,;) 




' 'Thirty-two bit bus tfaiisfers are equivalent to separated 6-bit% 
bus transfers with an incrementing address. , / ■'■ ' . 
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Table 3-7 Raster Op Addressing Modes — Continued 



Addressing Mode 



RasterOp Addressing Modes 
Notation ■ Description 



2 — Single Pixel Mode 
with RasterOp 



SRWPIX . • ', , _, , '*■'>, . / . . 

This mode accesses one, two or four 8-bit pixels in the frame 
■ ' I ; buffer. This mode is useful for painting 8-bit/pixel data into 
. ;\, ,\; , , the frame buffer. , , .... 

. ' ■.. . [ ^ On 8/16-bit writes, the data is transferred tb'the ROPC \'"^ ;! 
' , J- '],'':" .1 ■ - - ' ' source registers and on to the frame buffer memory. ; A byte <) 

.„ -. J > 'f, ."write loads all ROPC source registers with the value of that 
':/i\' • ;- 1 ^ " rribjt in the byte which corresponds to the ROPC's bit-plarie.v ; 
. . ■ '; V -: V , ' ..-Th^t isj bit zero of the data byte goes to all bits of the source 




' ) : An 8/16-bit frame buffer read access loads^&e ROPC desii-' 
' nation registers. A byte read returns an 8-bit pixel and a 16- 
bit read returns two adjacent pixels. , ;;.,.-,, . ^ : 

Thirty-two bit bus transfers are equivalent to' separate 16-bit 
bus transfers with an incrementing address. .' 
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Table 3-7 RasterOp Addressing Modes — Continued 



RasterOp Addressing Modes 
Addressing Mode Notation Description 



3 — Parallel Word Mode PVAVWRD . ./ ' 

with RasterOp 

and Hidden Read This addressing mode is similar to PRWWRD. However 

,' ; ; ', , , , read accesses have no effect on the RasterOp chips, and I 

'' '' , ;. ' \ ' ■ ' . write accesses generate a hidden read cycle to memory ,;:;' ' 

,^/!. '' . ■^, '/.' ' ■ , 'J . _. before the write cycle.' ■/.,':•., ' ; • ;' , ',' ' •<: \^^-;/, 

, - '- . r\-, ~ . ,",.-. In a write access, a read cycle loads the ROPC Jcyrfmzrzoh 

;- ;'>,•;!;, :''-"„' ■ ■•;;,•. ', ' ;,';. registers with the data in the frame buffer memory at the '• 
,, ' .'/'!:' .' \ _ • ► .' : 'address to be written, anci the write cycle loads the ROPC 

' ,5ourc£ registers from the.data bus as before. The ROPC out-.i 




Thirty-two bit bus transfers are equivalent to'separate 1 6-bit ' 
bus transfers, each with an incrementing address. 
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Table 3-7 RasterOp Addressing Modes — Continued 



RasterOp Addressing Modes 
Addressing Mode Notation , Description 



4 — Single Pixel Mode SW^WPIX • • - , 

with RasterOp ,■'.'' 

and Hidden Read This addressing mode is similar to SRWPIX. However, read 
; ,, . accesses have no effect on the RasterOp chips, and write 

'. . ' : ■' : - accesses generate a hidden read cycle to memory before the\ 
: •"', write cycle. - ,' '- -^C"---'' V '^- '"'•'" ^ >' ' ' 

- - In a 8/16-bit write access, the read cycle loads the ROPC .; 
, - " A J; V<^e-?^i'«<3fton registers with the data in the frame buffer ,/^ 

, ' '; : .',„,■'';;' Ct' 'memory at the address to be written, and the write cycled '^^ 

• ''-''.''""., 'y ' loads the ROPC source registers from the data biis as before., ; 
■--V-' ;V/ ,v,y;,-The'ROPC output is then written to one or two 8-bit 'pixels \ ■= 




. ; , Y'-j' ' ^: write accesses take four 16-bit meiriory ^cycles to c6mplete|^.j J 



Short and integer bus transfers in this mode are always 
equivalent regardless of the mix of Sun-2 and Sun-3 color 
and CPU boards. - - > - 
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Table 3-7 RasterOp Addressing Modes — Continued 



RasierOp Addressing Modes 



Addressing Mode 



Notation 



Description 



5 — Parallel Word Mode 
with RasterOp 



PRRWRD 



This addressing mode is useful for moving a region from 
place to place in the frame buffer. A single 16-bit move 
instruction (*fba++ = *fbb+4-) copies 16 8-bit pixels. Since 
this mode does not load the destination on a write, it is not ! 
useful for ROP functions which need the destination (for 
example, PIX_SRC ^ PIX_DST). , : , 

A 8/16-bit frame buffer read loads all 8 ROPC source regis- 
ters (128 bits) in parallel from frame buffer memory. A 16- 
bit firanie biiffei- write writes tlie ROPC output to all memory 
planes eriabled by the per-plane mask register without load- „. 
. ink either the source or destination registers ' 




(int) should still be used when using a Sun-2 CPU. 
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Table 3-7 RasterOp Addressing Modes — Continued 



RasterOp Addressing Modes 



Addressing Mode 



Notation 



Description 



6 — Parallel Pixel Mode 
with RasterOp 



PRWPIX 



On write cycles, this pixel mode is a combination of pixel- 
mode SRWPIX and word-mode PRWWRD. Read cycles 

k are identical to pixel-mode SRWPIX. On writes the ROPC 

",- source registers are loaded as with mode SRWPIX. For 
review, on 8-bit write cycles, data bit zero (DO) goes to all 

, . source register bits for bit-plane 0, and data bit one (Dl) 
' goes 10 all source register bits for bit-plane 1, and so on for 

, all eight bit planes.- On 16-bit memory write cycles, datum 
<D8,DO,D8,DO,D8.DO,D8,DO,D8,DO,D8,DO,D8,DO,b8,DO> 







^r '7, , *' -T. /',■ . • ""'1 -' •• ' . vl 



7 — Parallel Word Mode 
with RasterOp 
and Hidden Read 



^?:i;' Because this rnode provides'a meaiisforbroadcasti^ng 8 or' ;,? 
16 adjacent pixels with the same value,!32rbitjyME cycles ,,./ 
rhake no sense. A 32-bit cycle in this mode runs two back- ^ 
to-back 16-bit cycles to the same address. 



PWRWRD 



This addressing mode is similar to PRRWRD except that on 
write cycles, the frame buffer executes a read cycle to load . 
the ROPC destination registers before the write cycle is exe- 
cuted. As with mode PRRWRD, read accesses load the 
ROPC source registers on all bit-planes, and return the 
accessed datum. This mode is used for copying within the 
frame buffer when the ROP function requires the destination 
(for example, PIX_SRC | PIX_DST). 

A 32-bit bus read cycle performs two 16-bit read cycles, and 
causes the second 16-bit read to overwrite the data from the 
first read. With a Sun-3 CPU and Sun-3 color board, use 
only 16-bit cycles (short data) with this RasterOp mode. 
With the Sun-3 CPUs this causes little loss in performance. 
For performance reasons, 32-bit data (int) should still be 
used with a Sun-2 CPU. 
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Table 3-7 RasterOp Addressing Modes — Continued 



RasterOp Addressing Modes 



Addressing Mode 



Notation 



Description 



8 — Parallel PLxel Mode 
with RasterOp 
and Hidden Read 



PWWPIX 




This addressing mode is similar to PRWPIX. However, read 
accesses have no effect on the RasterOp chips, and write 
accesses generate a hidden read cycle to memory before the 
write cycle. In a write access, the read cycle loads the \ V 
ROPC destination registers with the data in the framebuffer.- 
memory at the address written to and the write cycle loads ; ;, 
the ROPC source registers frorn the data bus as before. The . 
i ROPC, output is then broadcast to 8 or 16"adjacent pixels/"/' • 
' Writefaccesses take two memory cycles to complete using ,;-; 
, .this addressing mode.^.V.v:/,^', ,-;:" /,',,;-,-., , is;'.';'.- ".{■'';..•;,';.,',, 

'''■fy^j/k '.r^ v'''> ■''■"' ' '" """si'''-''-' ' ■• - ' ■•' '\^i''^^^'K^'''^'i/^''':''''Ji:. 

.Because this iiiode provides a means for broadcasting 8 or') •,- 
-^^ 16; adjacent pixels with the saine yalue; 32-bit YME cycles,;<i 
>>jnalce*^ho slenseV^; A'32-bit cvd in this riiode runs two hicKM'L 







h's&iAU-. i^', 







V ;vr- '-^ The folio wmg table shows, the relationship.between the RasterOp mode^ 
' the status register," the type of access, and whether the, LD_DST and LD 

^''' :'} registers'get4oaded:fJ/j-^.Ji);|r/k>-^'V -V^-^ <■- ' • '; "■'.;/-^? jC",-/;. v, .„.\<. '.-i>';i '' 



',bits la'- ' 

Src'- 



ROPmode 


Mode > 


. Reads',.':, 




Writes 




bits in 


' Description ■' 


DstReg 


SrcReg' 


Dst Reg 


. • Src Reg 


Status ' • 




' loaded? 


loaded? 


loaded? 


loaded? 


000 


All 8 planes; , 


, ' Yes,. 


, No 


No 


Yes 


■ 001 ' 


1 pixel. 


' /"./-Yes 'V;/, 


-. No 


' , No ,■ 


Yes 


010 


All 8 planes 


' • ' No' ' 


No " 


Yes 


-Yes 


Oil 


1 pixel 


No: 


No 


Yes 


Yes 


100 


All 8 planes 


Yes 


Yes 


No 


No ,. 


101 


16 pixels 


Yes 


No 


No ' 


Yes 


110 


All 8 planes 


No , 


Yes 


Yes 


No 


111 


16 pixels 


No 


No 


Yes 


Yes 



All addressing modes specified as "word-mode** can be further delineated by the 
address range corresponding to each bit-plane. The breakdown of address offsets 
to bit-planes follows: 
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Table 3-8 Frame Bujfer Addressing in Word Mode 



Offset from Word-Mode Base 



Accessed Entity 



0x000000 - 
0x020000 - 
0x040000 - 
0x060000"- 
0x080000 - 
OxOAOdoO 
OxOCOOOOj 
OxOEOdOO • 



-OxOlFFFE 
-0x03FFFE 
-0x05FFFE r,\ 
-0x07FFFE:,> 
-0x09FFFE ' ; 
- OxOBFFFE 
-OxODFFFE,-; 
-OxOFFFFF. ., • 



Word-mode bit-plane 0. 

Word-mode bit-plane 1. 

Word-mode bit-plane 2. 

Word-mode bit-plane 3. 

Word-mode bit-plane 4. 
■ , Word-mode bit-plane 5. 
, ;Word-mode bit-plane 6. 
: Word-mode bit-plane 7. 



Pixel-Mode Addressing. 



l';,y".in pixel-mode,, e1^^ pixel occupies a byte value.' Pixel hiimberO is.inthe upp)er :•■ 
.r. .^.t.r. ---."_-_ _ir.t._" '._^^ --*? pixels are displayeihorizbntally towards 

address, a ne'i^f^eitical lineis^^ -. 





'3,2-;bits. The 16- and 32-bit accesses assume that two of four pixels'" are packed ,' v- 
■"ihto each 'datum. ''-.■'"/ '-' '"■' ;•-:.' .,^"'* : r /,;.."\'. ; ^-T-V-^v / ^'^C'lv-^lvV- -/?\v''^'r.' -', 



Word-Mode Addressing 



In word-mode, the frame buffer is configured as eight separate bit-planes.. Each 
bit-plane occupies a separate 128 Kbyte block of the system address space, and 
each bit-plane is architecturally identical to the Sun-2 black and white frame 
buffer. In this addressing mode, writing to the device alters 8, 16 or 32 horizon- 
tally adjacent pixels. Word is in the upper left corner of the display, and each 
scan line is 36 32-bit words wide (1 152/32 = 36). Thb most significant bit of a 
word appears to the left of the least significant bit of a word. Data written in 
word-mode can be v/ritten directly to the frame buffer, or it can be optionally 
combined via the RasteiOp unit with the data currendy at that address. This set 
of addressing modes, in conjunction with die RasterOp chips, may be used for 
painting raster font text 

A word-mode memory access may only address one of Ae eight memory planes 
of the frame buffer. However, all RasterOp word-modes (PRWWRD, 
PWWWRD, PRRWRD, and PWRWRD) access all eight memory planes in 
parallel. 

The color frame buffer memory is dual ported. One port connects to the synchro- 
nous system bus and the second is dedicated to video refresh, which has priority 
over system bus accesses. A new 16/32-bit damm can be read or written to the 
Sun-3 color frame buffer every 345/690 nsec. 
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Color Board Functions ...i;:.. .'.'..„;.„.„..!..„. „.„.l!;..'...i™.!.;:.„:.„. l.„..*:l!..„ ■. ,31 

4.1.' RasterOp Units .Ll...:l;..:.:^::..''li.: :L.lij..±:.ll/^::.-lh:..L...u.Li..jZ:: .„.. . ,31 



4.2. ' A single: RasterOp Unit 'lj::^jt}SiliS:jMl^I^ ''} \ 32 '■"' :C 

^^!^ h(,*^Raster6D On Re sister ^I^:':^ih!:i£2t{2i:iS^i^(3^ /"^ 32"; ' V; 




;4.3^;ColorMap ; :.... :..j„: L.:.:1!:1:;.,.;Iv:j:^:„:^„:j..„.^„„„„„._ . 35 

4.4. Interrupt Handling ..' ^ 1; :....„.... _ !„.„ : 36 •, 

4.5. Optional Double Buffering ...;.: .....: _.-..L:.y.„:., : 37 

4.6. Optional DMA Window and Frame Count „;„.i: ; 38 

4.7. 24-bit Color Configuration ._...„ ....„ : " J„ '. 38 

Installing 24-bit Color \.:..'...:1 1.:.. ...';.:..'„..J.....„...„.'...:.:..L..i 38 



Color Board Functions 



-This chapter describes the functions of the color board in detail. It describes 
■RasterOp units, the color map, interrupt handling, double buffering, and DMA. 
,-The information should help programmers understand the functions enough to 
interact with them. - ' - ' , - 




RasterOp, control registers can be accessed implicitly as well as explicitly. Expli- 
cit reads include, for example, reads to the RasterOp chips' registers. Implicit 
, reads take place when the source and destination registers are loaded implicitly 
. on certain read and write operations to RasterOp frame buffer memory. 

< ,' ' . Reads and writes to the pseudo RasterOp unit access all RasterOp units in paral- 
' ^ ~^ lei by writing to ropcoTitrolICG3_ALLROP]. Only those ROPC units on bit- 
^ - ' planes enabled by the per-plane mask register are actually modified. A read 
" from the ALLROP unit reads the value of ROPC plane registers. 

Implicit writes to the RasteiOp units only occur to the source and destination 
te^steis. All implicit writes occur to 2^ RusterOp units in parallel with no per- 
formance penalty. The uaJcs regarding implicit writes to the source and destina- 
tion registers depend on the addressing mode used (addressing modes are 
described in the chapter 5o/hvar£ Model): 

All explicit writes occur during RasterOp mode writes. During addressing 
modes PRWWRD, SRWPDC, or PRWPIX, frame buffer reads implicitly 
load the destination registers on all ROPC chips, frame buffer writes actually 
load the system bus data to the ROPC source registers, and the ROPC output 
is written to the frame buffer. The destination registers of the ROPC chips 
must be loaded any time the output of the ROPC depends on the existing 
frame buffer contents at the output address. This is true if the RasterOp 
function is a logical operanon involvmg the destinarion (for example, 
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P1X_N0T( PIX_DST)). It is also true when masking the first and last word 
of a raster line. 

With the addressing modes PWWWRD, SWWPIX, or PWWPIX, frame 
buffer reads have no effect on die ROPC chips, but frame buffer writes load 
the system bus data to the ROPC source registers. A hidden read cycle . 
loads the destination registers in the RasterOp chips, and writes ROPC out- 
put to the frame buffer. - 

With addressing mode PWRWRD, a frame buffer read implicitly loads the 
source and a write implicitly loads the destination of the ROPC. .;,!/ ' / 

, . . ' With addressing inode PRRWRD, a frame buffer! read implicitly loads both ' 

' , the source and destination ROPC registers. , A write loads neither, but the 
!- ROPC outpuns written to ;the frame buffer. 7 '/..', ;• , \ .,' '. ';';,'. 

V When using the RasterOp chips .with pixel-mode accesses, ROPC source register 
.^ ' bits are loaded based blithe^ address and data on the system busrjThe ROPC^ ' 
(, -source register' for frame bufferbit-plaiie /i loads,eyery, btlier bit with the .value of • 
' ; bit n in the data tyte;' If the address is' even the even bits, of the source register 




4.2. A Single RasterOp Unit , 



NOTE 



RasterOp Op Register 



' frame buffeh'InVother'w6fds;'theROrc'output in'piixel-mode is written through ( 
-' a write enable W" that brily 'the addressed pixels get v^tten.'. ,,-•/ ;.''v3 ;,;:, ,, 

The right mask and left mask registers in the RasterOp chips can be used to prop- 
erly clip the ends of the raster lines of a region to be painted,, • 

A RasterOp chip (ROPC) exists for each of the eight planes of frame buffer 
memory. The complete state of a ROPC may be read or written. Each ROPC 
unit consists of a desb'riation register, 32-bit source register,' pattern register, 
maskl register, mask2 register, shiftcount register, function register, width regis- 
ter, opcount register, decoder output latch, and an opcontrol register. This section 
describes the function of a ROPC and the registers which control it. 

The addresses of these registers are listed in the chapter Software Model. 

The rasterop chips are 16-bit devices and 32-bit frame buffer accesses are bro- 
ken into separate ] 6-bit memory cycles to the RasterOp chips. 

Each RasterOp has three operands; the source, destination, and pattem. The 
source is typically loaded into the ROPC source FIFO from the system data bus. 
The destination is typically loaded into the ROPC destination register from the 
frame buffer memory. The pattern is written dirccdy to the ROPC pattem regis- 
ter. The ROPC generates an output to the frame buffer by performing a bitwise 
logical operation on these three operands. The particular logical operation is 
specified by the op register. 
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The RasterOps support 256 possible functions, mapping three boolean operands 
into a boolean result. The frame buffer's 8-bit function register specifies one of 
these by acting as a three-bits-in, one-bit-out lookup table for corresponding bits 
of the destination, source, and pattern. For example, suppose you want to set 
destination equal to (Dst OR Src), ignoring the value of the pattern. The function 
may be expressed in tabular form as follows: ' 



Table: 4-1' , . RasterOp Register Functions 



PAT ':;„SRC; r, DST : DST\= SRC OR DST 



;:>0'^ 


'■'>■' ^OV--}' 


-A.^ 


=;'; ■.:(): I^i;:- 1 


.0, 


ri:VM^:Q 



':"•/.' 










RasterOp Source Fife and 
Shift Registers 



.?4 '^v; be loaded into, the frame buffer's function register.' ;, By convention^ the least - * 
?f}?P significant bit of die function'appeais at'the top.of the table; hefice mis function^'j^ 

vC (Src OR Dst) is represented by the eight-bit value 1 lion 
J= A '(^RasterOp. function applies equally to eachbit of a pixel; if bit n of the source is 1 
; . . and bit n of the destination is 0, then bit n of the output to the frame buffer will 
\: ,, , be 1. Examples of other function encodings are 0x0 (clear destination bits), OxFF 
■'■■. . (set destination bits), and OxCC (copy source to destination). To clear the entire 
, " - " screen, the constant function is applied to the viewable rectangle. To flash 
- (invert) a window, the function NOT Dst is performed on that window. The 
.^ • function SRC writes a character, the function NOT SRC \yrites the character 
'., inverted (black on white). Dst OR Src overstrikes (paints) the character, and Src 
OR Pat writes the character with a background pattern. Thus the Sun-3 Color 
Graphics board allows all 256 possible RasterOp functions, although in practice 
only a few are used. 

A ROPC has a 32-bit source FIFO called source] (right hand 16-bits) and 
source! (left hand 16-bits). This FIFO is for aligning source data with arbitrary 
pixel locations in the frame buffer. Recall that word-mode writes to the frame 
buffer are written to fixed boundaries. The source operand used by the ROPC op 
function is extracted from the FIFO as any contiguous 16-bit field in the 32-bit (2 
word) FIFO. The ROPC shift register determines which 16 bits to extract by giv- 
ing an offset from the right end of the FIFO. 

The RFO may be run in either direction. Bit 8 of tlie shift register determines 
the direction. Conuguous addressing may proceed either to the right or to tl^iC left 
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RasterOp Destination and 
Pattern Registers 



as needed in order to avoid overwriting the source rectangle when copying from 
location to location within the frame buffer. If the direction bit is 1 (right) a 
source load moves source 1 to source2 and moves the system data bus value to 
source 1. If the shift is non-zero then the FIFO may require priming (pre-load of 
the source 1 register) at the start of a raster line. If the direction bit is 0, a load 
source operation moves source2 to source 1 and moves the bus value to source2. 
In this case priming is done by pre-loading the source2 register. If the shift is 
zero then the source operand is taken from the end of the FIFO; if the direction 
bit is 1 then source operand « source2 else source operand = source!. . 



i,^" 



■j'-'y 



, The destination operand is the 16-bit ROPC ^5f register which may^ be impli- ; /. 
' ", citly loaded on aframe buffer read or write depending on the ropinbde field of , ':-, 
the status ^egister.^;The destination. operand is aligned with 16-bit words, in the ^ 
' cfrarhe buffer memoryVliV'i '{,'J.'\'^''S'^:;v'.^ ^..-•^■i 'W."- \'*^/,\ii-' ^'^y^ ':''vj/ •rf-'.'''.^'''''','^.'Av..r 

The patterri operand is the;16fbitROPC/7a«ern register which; must be, explicitly.-. 

iL'-j-j ul:";:!-:..:-' 'j:i1:'1:i:V'*1 ':^'Ct1':»Mi.' '■:' ^A:'lJ'j'''2l'i/:'x.:J^I^J:!i!!:lx:t'''-u::^Jl:^>^' 



RasterOp Mask, Width, and 
Opcount Registers 



NOTE 



NOTE 



loaded by 
daries 



wriring directly to itj'^rlt is always aligned on;.16rbit'frame buffer^boiiri:;.' 




the' 
frame 



8 ROPC decoder outputs arc wntten to the specified word:address m the,;?-.'- ' 

nebuffer:;;^^^^^jv,.^j>f'vv^7y .fcf .-''•'; V'/^'>i^i!?i:'SiS^.-^'''V^A%^ : < 



. The portion of a raster line to be written does not always begiii' and end on 16-bit 
boundaries. Therefore, the first and last portion of the raster line must be masked 
so that only the appropriate bits get written into the frame buffer. The ROPCs . 
perform this masking via the maskJy T7iask2; widthy and opcount registers. . ' 

The first and last J 6-bit 'word may be the same and both masks are then applied. < 
The width and opcount registers control the application of the masks to the first 
and last 16-bit words of the raster line. 

To use the masks, software must determine the width (in 16-bit words) of the ras- 
ter. The width register must be set to the number of 16-bit boundaries crossed by 
the raster. If the raster is entirely ^contained in 16-bits tiie width is zero. If the 
raster is only three bits wide but spans a 16-bit boundary, then the width of the 
raster is one. 

The opcount is a variable register. At the start of a raster line it must be expli- 
citly loaded with the same value as the width register. It is automatically decre- 
mented by the ROPC hardware every time the destination is implicitly or expli- 
citly loaded. 

This is probably a design flaw' in the ROPC. In some cases the opcount should 
auto-decrement when we are not loading the destination on frame buffer 
accesses. 
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When the value of the opcount equals the value of the width register, (that is, the 
first 16-bit word of the raster), the maskl register is used to mask bits in the des- 
tination from modification. A 1 bit in the maskl register causes the correspond- 
ing bit in the decoder output to be given the value of the corresponding bit in the 
ROPC destination register. Therefore, the destination register must be implicitly 
loaded from the frame buffer memory on writes which need masking! A bit in 
the maskl register causes the corresponding bit in the decoder output to be given 
the value of the corresponding bit in the three operand RasterOp ftinction output. 
Ai When the opcount is zero and a destination load occurs, (that is, on the last 16-bit 
'-;' word of the Vaster line to be written), the mask2 register is used to mask destina- 
; ,^ tion data bits froin.modificatioiL Also, on this last word the opcount is automati- 
■" cally loaded with the vJaliie of tfie width register and tiie cycle repeats. This 
,r,. mechanism improves graphics performance by allowing the software to set up . 
>; the end masking and source shifting once for/an entire rectahgularRasterOp. An 
1 S; unwrapped inner loop can move all the words.of the rectangle. .-There is no need - - 
'■ ' to explicitly loaii any ROPC registers when moving from one scan line' to the ^ 

' ' and •'." 




•■' ;,/.;,) >T6 display the image in the Sun-3 color frame buffer merhory, each'8-bit pixel is 
, - used as an index into a 256 element color lookup table. Each element of the- 

table is 24 bits; 8 bits "drive the red DAC, 8 drive the green, and 8 drive the blue. 
. (For 24-bit color configurations, only the red DAC is used on each board). The 
, color lookup tables consist of a high-speed ECL lookup table used during video 
A- display, and a 11 JL shadow color lookup table that can be accessed at any time 
"by the host software. The TTL shadow mask eliminates the software problems 
associated with allowing updates of the color map only during vertical blanking. 

' The map acts like a 256 X 24 RAM bank: the values stored there represent 
colors. The low-order 8 bytes of each map entry represent red, the medium order 
byte represents green, and the low-order byte represents blue. The value of the 
color is proportional to tiie value in the byte: the higher the value, the higher the 
color density. No value (24 zeroes) creates black, and all colors (24 ones) creates 
white. 

Tlie ORed value of the update_ecmap control bit in the status register and 
update_ecmap control bit in the double buffering register defines the coupling 
between the host software and the color maps. When the ORed value is zero, the 
TTL color map can be read or written. When the ORed value is one, the TTL 
color map cannot be read or written and instead is used to load or unload the 
ECL color map during vertical retrace. 

The read_€cmap control bit in the double buffering register controls the transfer 
direction between the maps. When update_ecrnap and read_ecmap are set, the 
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ECL color map is transferred to the TTL color map. When update_ecmap is sei 
and read_ecmap is cleared, the ECL color map is loaded from the TTL color 
map. 



All entries to the color map are on 16-bit boundaries, and are stored consecu- 
tively by entry number (0 to 255) and by color (red, green, blue). Only data bits 
through 7 are used. For example: 

color map red, entry, #0 is at address 0x110001 (data bits D7-D0) , ;'\ 

color map red, entry #1 is at' address 0x110003 (data bits D7-D0) , ', f.. ' .', - \ '. 

color map red/ entry #2 is at; address 0x110005 (data bits D7-D0)' C ■' '»'<•,' ^ ' \ 

color map red, "'entry' #3 is -at 'address 0x110007 (data bits D7-D0) ,'j,, "•','•',':' .\\ , 

color map' red,',' entri^^v #255 is at. addr OxllOlFF (data bits 'D7rDp) |, ','/' '••>';•'' , ^ ,\ 

color' map' grn, entry f#q is at .address 0x110201 (data bits D7-D0');.'"; "','/' ''^'7^ ^ ' '''* 

— lor map'grni' entry:,' #i> is' at - address," 0x110203 ' (data -bits D7-D0) ... ^ ';' /;,•/,-?;'.'; .'_,. )■• 

lor. map'grn;''';' entry;' #255'' is a£/'addr " 0xll03FF. ' (data bit's' p7-Dp) Xd^i^^'^' .^^^(rr''^^;:fi ^^ : 




chronously but' are sersyhchr()n6usly with the' start of vertical rep'ace^Syncnrori- * f 
izing the assertion of update_ecmap ensures that the entire color, map, is ^.updated, ^ \\. 
in a single vertical retrace period, and making deassertion of the, update bits asyn- ' '" 
chronous allov^s programs to deassert the bit, immediately load the TTL map and 
then reassert update_ecmap without requiring any busy-wait polling loops. The 
status bit read_ecmap is always synchronized with the start of vertical retrace. 

4:4. Interrupt Handling ' Interrupts can be generated at the start of vertical retrace., Interrupts are useful - • 

for preventing tearing during mouse and pop-up menu activity. They are also 
very useful for double-buffering applications that wish to toggle 
foreground/background every A' frames. 

Enable interrupts by setting bit inten in the status register. At the start of a yerti- . 
cal retrace period, an interrupt is generated at VME interrupt level 4. During the 
VME interrupt acknowledge cycle, the board returns the VME interrupt vector 
stored in the interrupt vector register. The host software can use a unique vector 
for the color board or it can share that interrupt vector and determine the source 
of the interrupt by polling the status register bit inpend. 

To ensure compatibility with Multibus device drivers, the VME interrupt remains 
pending until the inten bit is cleared. 
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4.5. Optional Double 
Buffering 



Some color boards are manufactured with an extra megabyte of frame buffer 
RAM. This is used as an extra frame buffer, which shares its inputs and outputs 
with the original, and which is used for double-buffering images. While the con- 
tents of one frame buffer is being displayed on the video monitor, the other can 
. be updated. 

Bits in double-buffering register control the fimction of the double buffer. The 
buffers are designated buffer a and buffer b, or ih& foreground RAM and the 
• background RAM. By changing the bits in the double buffering register, the pro- 
/grammer caii toggle the definition of foreground arid background, and select - 

"/ which buffer to write to or read from. --,,,'' ^ r. '■:^f\ } - -^ ^ ' ; 

;-' "^ . '^ ; ., ' , •; ■ ' '-.'fxV' ,"''<,'':"■" V '■"'^■' •■:'',■" />• " ^ 

: The relevant register bits are: .. /.;• . . -> ,,.',; 

\''i-V.'/-.- '[ ,..' : ■ , '■-:".•■, ' ' ' ', .'•-''""■,"--', '-^ * \ ,.,V "'^ ■ '/ , '•'• '■ 

?fhowrite;;_ia- 'r-,/ "''';'. / ;'-' '-[ '-J: '^'' -'''"''^'■'^^'"•'i.-V'^''-^''"'''-'^': --"'"V';'' -- ' \^ 
I'^.tViWhen this bit is cleared, writes to double-buffered niemoiy set A are'; 




When this bit is cleared, frame buffer read and "hidden-read'' cycles access 
." V memory set A. When this bit is set, frame buffer read and "hidden-read" 
cycles access memory set B. ' . 

NOTE \, The programming model of the color board assumes that programs not using 

■'-'' double buffering write to both buffers. These programs can read from either set, 
and can display either set, without being affected by programs using double 
buffering. The Sunu>ols default is to write both sets of RAM and to read from the 
foreground • ; 

When writing to the background frame buffer only, a process should lock using a 
null rectangle so that the cursor and mena do not have to be lifted. (Recall that 
the kernel only lifts the cursor if it is inside the rectangle specified in the call to 
pw_lock.) This prevents the cursor from flickering when it is in a portion of the 
screen to which background writes are being made. 

Transient objects such as cursors and menus should also only be written to the 
foreground buffer. In this manner, only the foreground buffer will need to be 
saved for replacement. This convention applies everywhere on the screen and 
serves to prevent damage to the background of double buffered windows. 
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6. Optional DMA ^Vindo\^ 
and Frame Count 



4:7:f2^;b t:coi6H>^ 

J ' 'Configuration 



Double buffered boards come with a circuit to map read and write accesses in the 
offset range 0x32000-0x3FFFFE to an address defined by a pixel-mode address 
counter. The pixel-mode address counter is set to an initial value by writing to 
the DMA base register. This counter holds the starting pixel address of the win- 
dow (upper-left comer) in 16-pixel increments. In other words, the DMA window 
base equals 16 times the value written to the register. 

Read or write accesses into the offset range 0x320000-0x3FFFFF are remapped 
into the frame buffer: address bits A03 to AOl and LDS and UDS from the VME 
bus are appended to A19 to A04 from the DMA iaddress counter. The data is, , 
then written directly to, or read from the frame buffer. The DMA window' ,. / 
transfers are not mapped through the RasterOp chips; they funcdon like the '. ,' 
pi xel -mode accesses described in the chapter 5q/hvareAfo^/. , ., v 

After the number oif DMA window idata transfers equals the value of the write-,' ^ 
. only DMA width register multiplied by 16, the DMA base is incremented by..,,; ,, 
CG3£WlDTHminii'sDMA_width_reg*16. This way, consecutive accesses iiito- 
. the DMA 'window space'map properly into a raster on the display.;;; 'J i, ^n,, ,;^4 '4>; 

; The vertical height of the DMA window is implicitly set by the riumbefof bytes v 
►;• transferred intq;orout of the window space. It is the responsibility of the,user,'.;V' ,^ 




NOTE 



syisterh to display all 16 million possible color combinations, instead of the 256 
stored in a single color map' '"'■ ' '" " '"- ' ' ■, '; "V -^V,^•,^^ rM'j/'^'r., 

The three boards in a 24-bit color configuration act independently, reside at dif- 
ferent addresses, and must be configured in the UNIX config file. Only the red 
DACs and color map entries are used; the 8-bits from the first board generate the 
red, the 8 bits from the red map in the second board generate green, and the 8 bits 
from the red map in the third board generate blue. The first board also generates 
the video sync, vertical reset, a 92.94 MHz master clockj and a 5.81 MHz master 
clock to the other boaixis. 

In all other aspects, these boards work as described in this manual. 

The 3-board 24-bit color option requires 8 Amp at -5 Volt even with depopulated 
DACs and hence may not be a legal configuration in some systems. 



Installing 24-bit Color 



The simplest addressing scheme is to place the boards in the 16MByte addressing 
space, with the first at 0x400000, the second at 0x800000, and the third at 
OxCOOOOO. On a Sun-2 with limited addressing space, they can also be 
configured to occupy only 2MBytes of space each, but this will cause the diag- 
nostic to generate spurrious errors. On a Sun-3, they can be placed in the 4 
Gbyte addressing space, but this requires modifying the existing UNIX driver. 
For more detail, see the "Engineering Manual" (#800-1366). 

The "Sun Configuration Procedures" (#813-2000) show the jumpering required 
on each board in the single-board (standard) configuration, and in the 3-board, 
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24-bit color configuration. Note that the 24-bit color configuration requires 
adding a 5 nsec delay line to the first board, and a 3 nsec delay line to the second 
board. These are simple LC circuits provided in 3-pin SIPs; stuff pin 3 of the 
delay line into pin 6 of J 100, stuff pin 2 of the delay line into a pad 0.1 inches 
below pad 8 on J 100, and stuff pin #1 of the delay line into a pad 0.2 inches 
below pad 8 on J 100. 
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Programming the Color Board, l!;„:.i.;:/j...:„.v:.::„..::„.?ll.. '..::.lj::.:'.i..:l '43 " : 

.;-!5. 1 :';, Mapped' I/O Hardware interface;:l.^;.£hilJ:.l:.:^i...L..il:.:j!l^ '"43}'^; 

;v'^:2; 'Coordinate "Systejii;.:V:£ ',/! 47''^. 

Vf .^;i' ':' ' Pixel Mode' ^ ^^- • ' 5'l'^';^^ '' '^i^^.;/:^^; '^ j?:^^;^>'<^^' V''i:. r^:. :%h<:i^ ■'■ ' ,.. -/dT'^ 



Programming the Color Board 



. I This section provides detailed information about the functions and the registers • 
^ 'of the Sun-3 Color Graphics board. These include the color map, the status regis- , '. 
y-'-ter, and the per-planeRasterOp units., / ,f A-j- ' f:',.,"-^ '- , '^ ' , . 



5.1 . ' Mapped I/O Hardware ;/ f^' ;.; The. files cgSreg.h and memreg.h contain the following description of the address ' ;: 




#define CG3_LINEBYTES 
^define CG3_KEIGHT 
#define CG3_DEPTK 

struct cgSnemfb { /* non RasterOp frame buffer access */ 

Word mode accesses 

union bitplane { - -' /* word-mode memory */ 

long word [CG3_HEIGHT] [CG3_WIDTH/(8*sizeof (long) ) ]; 
char pad[128*1024]; 
) memplane [8] ; 

union byteplane { /* pixel-mode memory */ 

u_char pixel [CG3_K£IGHT] [CG3_WIDTH3; 
-■ char pad[1024*lD24]; 
} pixplane; 
}; 
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* Details of the status register. 

struct cgSstatusreg { 

unsigned f lagl5 , 
unsigned flagl4 
unsigned f lagl3 • 
unsigned f lagl2 

• ,, ,. .unsigned flagll , .■ ^ 

.'", , unsigned f laglO ;'- '. ' 
'}-"] unsigned flag09 
; unsigned resolution 



1; 
1; 
1; 
1; 



7* 
/* 






User/system defineable jumper 

User/system defineable jumper 

User/system defineable jumper 

User /system defineable , jumper */ 

: 1; /* User/system defineable. jumper */ 

:"1; 7* User /system defineable., jiimper */. 

: 1; /* User/system defineable jumper */ 

: !;• /* screen' resolution •*/;. . ; ' ''''.\. 

"/*'0 = 900 x-1152 */ "'^ 




■'/''.■'••: 



* Details of double' buffering register.' 
Including bit assignments 



*/ ■ 

struct 



cgSdoublebuf {, 

unsigned display_b : 1; 

unsigned read_b " : 1; 

unsigned nowrite_b : 1; 

unsigned nowrite_a : 1; 

unsigned read_ecmap : 1; 

unsigned fast_read : 1; 

unsigned wait : 1; 



/* Display memory set B or A., Syncronized */ 

/* to start of vertical retrace */ 

/* Read memory set B or A */ ' 

/* Do not update memory set B ' on writes */ 

/* Do not update memory set A on writes */ 

/* ECL to TTL cmap transfer direction */•, 

/* Syncronized to start of Vretrace. */ 

/* Return invalid data but fast Dtack on rd 



/* Write a 



to set. Bit will remain */ 



unsigned update_ecmap 



/* high until a full vertical retrace period 
/* has elapsed. The bit clears itself */ 
1; /* ORed with cg3statusreg.update_ecmap */ 
/* Bit duplicated to allow easier */ 
/* syncronization of color map updates */ 
/* with double buffering frame toggles */ 



*/ 
*/ 



reserved? 


: 1; 


reserved6 


: 1; 


reservedS 


: 1; 


reserved4 


: 1; 


reservedS 


: 1; 
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}; 



reserved2 
reservedl 
reservedO 



1; 
1; 
1; 



* RasterOp hardware registers. 

V, ^V. ..■'■'. \ ^ •;,.:' 

struct 'memropc,. { ''. ;. - ■'.'.,,, . 
-'• '- "v '''-' ^J.'^^V^''^ ''inrc_dest;, ,"'_ J^., 

- ■' -V r''^. '.■•'''-' uj_shdrt ^ mrc_source2 ;V ' ' ' 
'A'. '. ^^'''y^^'^V• u short mrc sburcel; ,- / 




vV. V*\ destination', register ,• '*/ -\ \ ,; 
'''''\,,;/* '^sdurce2,.-register'' (left) " , */ 
.''V/^/;Sourcerv'register /.(right) */ .',.;;!.;'• 
■ /* -pattern' register ;;: " .. '^ ! */ , 

,? register'"-.. ^;_; .o-v .. • v^o*/ ' ''. ,</'- 

>k2/ register •'^; ,^:;, ;„-. ..^ •,''>---''*/, ■' - '-,. - ^•'•'' ; 

13 shift' count forVsource' */ 




*'If \6nly ROP-mqde accesses' are required, • cg3fb is .the only struct . which 'must- , 
Z'^- be .'mapped ''in order, to'use , all Color board- features . ■ ' 

, \ '. • ' Corresponds to RasterOp memory and control registers > \ ' ' ,' 

struct' cgSfb J ■ ,. - ' , ' ', _ , - ', ''■.,:''' 

,..,,'- -•'->;. union 4 ; n'...' ' ' , --,,>'--/* ROP -mode' 'memory */ .-. - ';- ' 

':' , ' ■'^^■•'> • •' ' ^ ' union bitplane ropplane [8]';^\-*^' •t'/^ word-mode 'memory with ROP'*/ ' 
- - union byteplane roppixel; /* pixel-mode memory with ROP */ 
'} ropio; . , '- RasterOpmemory — 0x200000 to 0x2FFFFFF '\ 

' .' unioiiM ' ' ' ' • - /* RasterOp chip registers */ 

, . ' ., "- ', struct memropc ropregs; /* normal register access */ 
- , ' •', struct { 

char pad[2048]; /* for pixmode src reg prime */ 
struct memropc ropregs; /* byte xfer loads alternate */ 
} prime; /* src register bits */ 

char pad[4096] ; 
} ropcont r ol [ 9 ] ; RasterOp control regs 



union { /*■ 

struct cgSstatusreg reg; 

short word; 
char pad[4096] ; 
1 status; 



status register */ 



#s 
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union { /*■ 

unsigned short reg; 
char pad[4096] ; 

} ppmask; , . 

union' { . , '', .1',^ . . ', . '^ -' ' " v /*• 
struct .cgSdoublebuf reg; 
;\ short', word;, ' '.\. 
- \. _ • >', >,:.'.- char, pad [4096] ;•', ' 
;;, ,: )\ doubletbuf ;/,^ ><_,,/.■■',,!;$ ^^,; ,v .\>,;..t 

^■\ , 'union •^^y;?^?:^^■^^^'fe''^^ 



per-plane mask register */ 

/* 8 bit. 1 bit -> wr to plane*/ 

/* D07. .DOO */ 



double buffering register */ 



/..''-;,'":: .'/'uh'sighed short reg; 



"'.')/*" — ;-r/dma window' ;6rign register..*/ 

. I ^Y ;,":,; y.-/* Bit's," "A19-A4 pf DMA window:*/ 



t -'.,:.'-." ;•^^^;l^?i^$:;'l^^■'';?";'^\^^V.■-'^^^ ''' '.'■/ '-;'';•'-;;;/*; originv|WriteTqnly.;;167bit .*/ 

'f J^;:}:,:dmalDase;>'^;[;^^ ;,•. ; ^ ';_','- ( ' J; ,,;;;,, ;/• / ^,vt, &'}i^-tet;j?^'^);'\ v ^!i^^'- ^:v^ n* : '' 




'-y'^ : ' '^ ^"-^ ''f;''^:5^^i:^';^:^!!l>C^^^Vv:/J^'^; ' ;!•'• -' ■.. ^^'^ . '' >-''';. ir /* DIS'J :D0'8:::'-'ReadTonly i') */'•;' k ■ 

i /' ' \ ' >- '1,' ' ', ' ,' ' /* -f t-aTno"- •nnm'Ko'r' morlnln 9 ^ f^ ' ■* 



char pad [4 96] ;" '-, •' 
} f ramecnt; , ' , "-• . ''-;■- 

union { '/- j .,' ,-< ^' ."', • '; ^ ', ,' , 
'- ' •' , unsigned short reg; 
; ,char pad [40 96] ; 
} intrptvec; . • . 



/*- 



/* frame"; number' modulo 256.' */ 
/* Increments on • Vretrace. '*/ 



interrupt vector '.register */ 
'//* line number ^6l-:-io24/4 ■ */ 



unsigned short 
unsigned short 
unsigned short 



redmap [256] ; 
greenmap[256] ; 
bluemap[256] ; 



/* shadow color. maps */ 
/* shadow color maps */ 
/* shadow color, maps */ 



}; 



/* 


ROPMODE 






PARALLEL 




LD_DST 


LD_SRC 


Description 


* 












ON 


ON 


*/ 


tdefine 


PRWWRD 





/* 


parallel 8 


plane, 


read 


write. 


wrdmode */ 


Idefine 


SRWPIX 


1 


/* 


single 


pixel. 


read 


write, 


pixmode */ 


#define 


PWWWRD 


2 


/* 


parallel 8 


plane, 


write 


write. 


wrdmode */ 


#def ine 


SWWPIX 


3 


/* 


single 


pixel, 


write 


write. 


pixmode */ 


#def me 


PRRWRD 


4 


/* 


parallel 8 


plane. 


read 


read. 


wrdmode */ 


#def ine 


PRWPIX 


5 


/* 


parallellG 


pixel, 


read 


write. 


pixmode */ 


T^def ine 


PWRV7RD 


6 


/* 


parallel 8 


plane, 


write 


read, 


wrdmode */ 


T* define 


P^-TWPIX 


7 


/* 


parallellG 


pixel, 


write 


write, 


pixmode */ 






# 


see 
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/* 

* ROP control unit numbers 

V 
#define CG3_ROP0 
#define CG3_R0P1 
#def ine CG3_ROP2 ' 
#define CG3_ROP3 
#define CG3_ROP4 
#def ine CG3_ROP5' ' 
,'; #def ine , CG3_R0P 6"; \^; ' 
""Idef 'ine' CG3_ROP7-- ''!!r 
.redefine, CG3'ALLR0P -; 



.'';-r 



-: ' , v.# d:e J ine'j CG^S RC 
"r, '^^'fclef ane ' CG'- DEST ^'-V- . 
,.':,\#defirie CG 
■;;,!'; #defane '-CGi^ 
..V>#de'fine';CGOP> 






/* 


1 


/* 


2 




3 




4 




'5 




' 6 ' '- 




:i ■ ■' 


1 


:8 •> ^ - . 


,/* 




/* 


bxcc;. 


I ,- <; \ ■ 


OxAA !. 





RasterOp unit for bit-plane 
RasterOp unit for bit-plane 1 






>V ''• 



- ,, . /*\ writes' to^-all;units , enabled' by PPMASK */; ., 
/*' reads from plane .'zero ROPC registers */ '. 



pP£NEEbs£MASK (op).:'b^f;;4J^>iJ|^'^i :C ^ ( (.(op) >>4)i t 



(op) \ ,r,& XG_lNOTMASK)\„'-^> 




'V -'-//.^t;. '. '■■:-/ ^- •.•;;' ■■">,' (&-(fb) ->:memprane [ (prarie) ]'fwbrd ['(y)"'] [Xx) >>4] ) ' {' : ' ' .'""• .' ' 
o,#define' cg3_roppixaddr (fb, ',x, _y)s ■'- .:;;■[' y,'i^(^^^'l^j i\ -'-'..>'• ' ■ •; , •',^''',^. .'".V-- '\-!, 



(& (fb) ->ropio.roppixe'l. pixel [ (y) ] [ (x) ] )- 

rdefme cg3_ropwordaddr (fb, plane, x,,, y) ' - ' \ 

• '\ ' '(& (fb) ->ropio.ropplane [ (plane) 3 .word[ (y) 3 [ (x) >>4] ) 
^define cg3_jprskew( x) • - < , - \ 

. ■ ■ ■ , ' ((X) & 15) -:: • ' ' 



5.2. Coordinate System 



Pixel Mode 



The frame buffer memory is configured as a memory image and is not directly 
x,y addressable. The coordinate system starts at the upper left, with y increasing 
downward and x increasing to the right. In pixel-mode, the Sun-3 color frame 
buffer appears as one million 8-bit pixels via cg3memfb.pixplane.pixel[y](xj. In 
word-mode, the Sun-3 color frame buffer appears as a stack of eight 128 Kbyte 
moiK>chrome frame buffers (cg3memfb.memplane[n].word[y][x/32]). Writes to 
the frame buffer can be opdonally mapped through the RasterOp units via 
cg3fb.ropio.roppixel.pixel[y][x] or cg3fb.rDpio.ropplane[n].word[y][x]. 

In pixel -mode, pixel number is in the upper-left comer of the frame buffer and 
pixel number 1151 is in the upper-right comer of the display. Scan line y in the 
frame buffer (0 < y < CG3_HEIGHT) always begins at pixel number 
y*CG3_WIDTH and ends at pixel number (y+l)*CG3_WIDTH - 1. 



^.. 
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ord Mode In word-mode, each scan line in the frame buffer is 36 32-bit words wide (1152 

pixels/line divided by 32 pixels/word gives 36 long words/line). The MSB of 
word number zero for each bit-plane is located in the upper left comer of the 
frame buffer, and the LSB of word 35 for each bit-plane is located in the upper 
, : right comer of the frame buffer. Each successive scan line in the frame buffer 
, ,; ' ., occupies another 36 32-bit words. ,' ■ , ; : ,'' V,' \ > 



5.3. Progr 



amming Examples ' i,, ,, The following code sets up the, Color board registers iip preparation for copying a 
,; ': ;, ',;f^' pixel rectangle having 1 bit per pixel (packed 16 pixels per short \vord) from ' 




,fb->ropc,ont'rol[CG3j^lLLR0P];.ropreg^ ;.' ' V V 

'fb->ropcontrol'icG3j!_ALLRdP]''.'ropr V'-" '"''- ''■'' 



■right mask is based on' the- right' destination. position /skew. . 



/* ' - ' ■>«';■' . ' ' ' ■ ■■•','■/ ".f .'-,'' \ ■ 

* Set the ',end mask registers in all ROPCs.' The ' left, '.mask /is > based, 

* on the left destination position skew. (the left: end .of. , the (.raster) V 
^ and ,the 

*/ " ; " 

f b->ropcontrol [CG3_ALLR0P] : ropregs'.mrc_maskl' 

mrc_lmasktable [dst .pos -X &' OxF] ; \- , V ■,.' , 

fb->ropcontrol [CG3_ALLR0P]-. rbpregs .mrc_mask2 = •, .,, „ ''■■'\',.' ■','■- 

mrc_rma skt able [ (dst .pes. x+dst. size, x-1) & OxF]; V' ", 

/* ' /■"•■''/. '' '■ . ■ 

* The source load bit is 1 so the FIFO is moving sourcel to source2. 

* Therefore, the src and dst addressing will increment left to right. 

* Set the shift and the sourceload bit in all ROPC shift registers. 
*/ 

dstskew = cg3_prskew( dst .pos. x); 
fb->ropcontrol [CG3_ALLR0P] .ropregs .mrc_shift = 
(1 * 256) I ( (dstskew-srcskew) & OxF) ; 
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* The source FIFO must be primed under certain conditions. 

* Width is the number of word boundaries crossed by a raster line 

/''prime = ' (srcskew >=/ds'tskew)';' ''■■!";:.■'/''•'' '- * '-\-'~ 
, .-'width =■' (dst'isize.x + dstskew -1)^:/ -16;'^' - , .■;''; - ', ''- •, 




[-}'dxj=< dst3_addr ;,4 -rKj;\' ^^'f,^)-^/*--',^^ As-'->^^iword;'address '.* / 
'i^af .'/(prime)' '^ i '/.; rV •, {\'''';. /"^J^^i ^::^^^^7-^"^'^)^:';)'^^^ '.■ \' ' - ' 

': '^ ■;'- ■' 'fb->ropbbritrol iCG3_ALLR0P] ".ropregs.mrc_sourcel 
'/•,'; ■',,;/ ' '\ '■'".' '• *src_addr++'; -* •'";-;■, '.7V. ' / 

'rbp_f astloop (width, . *dx+.-i:' =. *src_addf++ ) ; 
./*dx++'= *src_addr; ^^'■' v) ''" ''•■- ■''' • '' 

,; dst_addr _+='XG3_LINEByTES;''^^; 
v/( ch a r y * ) ma j_t op ' += ma_ve r t ; *- ' ■ 
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coIoEmagjBS 

decQiajccTegiSteripS! 



ifliiexphciMasterop'Unit access.tS 1, , 

■y-'''*r4i 

Pi 



iis^laaaress space;'! 3' 
'implicit rasterop;unitaccess;'31 ' 

^intOTUplSj^SO; 

^; 

•■Vi vj,i« '-'•-■'; 

'niaslcf register; 34= 

■■•' ^ C'-^^' 

_^__;Ni 

' ilon-RasterOp' addressing modes, 20 

''";*/:"■'■'''' ' 

J op^ register,, 32 .';■■ ,^ 
opcbiint register,' 34 ' 




tprogramrmng, 43,^-11)!^ 
>pscudo rasterop umt,';31 



!RasteiOpr-2Qjf 




WjregistcfS32'« 
;:j^opcount register,'34, 

fixscudo;;3]g^?}r^5J 
i shift rcgister,'33">i 
■^^.width register, 34 ' 
^•^•^15 register, 35v^ 
'.'ifrastCTop unit access 
,';e'xplicit^31''':/i'»; 

^___|iinplicii,-;3l|J^,,.^,^^.^^^ ., 

?^'i^tcr6p'!u"nii source H1^0,'-33 
■X rasterop' units, 31 ''^<'' ;%\ 
'i;; ropmode,'21 ;^^V^ IJ'tf 
*4 > ropmodc notation, 2 1 ^ 

/Ashiftrcgistcri 33 ; 

i;|' source' FIFO, 33 .^■ 
';;5 status register, 17 



; Three-board configuration, 38 

w 

width register, 34 
'word-mode addressing, 28 

xl5 register, 35 
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